home *** CD-ROM | disk | FTP | other *** search
/ Ian & Stuart's Australian Mac: Not for Sale / Another.not.for.sale (Australia).iso / hold me in your arms / PGP 2.6 / rsaref Toolkit / doc / rdemo.txt < prev    next >
Text File  |  1993-01-19  |  5KB  |  111 lines
  1.                                 RDEMO:
  2.                    Demonstration program for RSAREF
  3.                             User's manual
  4.  
  5.                            RSA Laboratories
  6.                             March 2, 1992
  7.  
  8.     Copyright (C) 1991-2 RSA Laboratories, a division of RSA Data
  9.                             Security, Inc.
  10.  
  11.  
  12. This note describes RDEMO, a demonstration program included with the
  13. RSAREF cryptographic toolkit.
  14.  
  15. RDEMO is a simple program that exercises RSAREF's cryptographic
  16. operations. With RDEMO three "users" can perform the cryptographic
  17. operations of signing, sealing, verifying, and opening files, as well
  18. as generating key pairs.
  19.  
  20. RDEMO has a main menu with six commands. The main menu is displayed
  21. when you start up RDEMO, and is displayed again after RDEMO performs
  22. a command. After you select a command RDEMO prompts for parameters
  23. such as file names.
  24.  
  25. RDEMO's commands and their parameters are summarized in the following
  26. table.
  27.  
  28.  
  29.           RDEMO COMMAND                       PARAMETERS
  30.  
  31. S - Sign a file                 name of file
  32.   sign contents with private    whether you want content encoded
  33.     key                         which user you want to sign as
  34.   optionally encode contents    name of file in which to save
  35.     in PEM character set(*)       signature
  36.                                 name of file in which to save encoded
  37.                                   content(**)
  38.  
  39. E - sEal a file                 name of file
  40.   sign contents with private    which user you want to sign as
  41.     key                         which user you want to seal for
  42.   generate random DES key       names of four files in which to save
  43.     IV(***)                       encrypted signature, encrypted key,
  44.   encrypt content, signature      IV and encrypted content
  45.     with DES key         
  46.  
  47. V - Verify a signed file        whether content is encoded
  48.   decode contents if encoded    names of two files in which (possibly
  49.     in PEM character set          encoded) content and signature are
  50.   verify signature on             saved
  51.     contents with public key    which user signed the file
  52.                                 name of file in which to save
  53.                                   recovered content(**)
  54.  
  55. O - Open a sealed file          names of four files in which encrypted
  56.   decrypt encrypted DES key       content, encrypted signature,
  57.     with private key,             encrypted key and IV are saved
  58.   decrypt encrypted content     which user signed the file
  59.     signature with DES key      which user the file was sealed for
  60.   verify signature on           name of file in which to save
  61.     contents with public key      recovered content
  62.  
  63. G - Generate a keypair          length of key in bits (508-1024)
  64.   generate RSA public/          name of file in which to save key pair
  65.     private key pair
  66.  
  67. Q - Quit
  68.  
  69.  
  70. (*) A 65-character subset of ASCII defined in RFC 1113. Most other
  71.     quantities are encoded in this set automatically.
  72. (**) Only if content is encoded.
  73. (***) Initialization vector for cipher-block chaining mode of DES.
  74.  
  75.  
  76. NOTES
  77.  
  78.   1. You select a user by number: '1', '2', or '3'. The first two
  79.      users have built-in RSA key pairs. The third user's key pair is
  80.      the one generated by RDEMO's 'Generate a key pair' command. The
  81.      third user is not active until the key pair is generated.
  82.  
  83.   2. How you specify file names to RDEMO depends on your operating
  84.      system. RDEMO recognizes the special file name '-' as the
  85.      standard output stream (typically the screen display). You can
  86.      usually cancel an RDEMO command by giving a blank line in
  87.      response to a prompt for a parameter.
  88.  
  89.   3. RDEMO reads most files and writes all files in binary mode. The
  90.      only exceptions are the files containing contents to be signed
  91.      or sealed. Those files are read in text mode, one line at a
  92.      time, with RDEMO replacing any <CR> and <LF> delimiters with a
  93.      <CR><LF> pair before encrypting, computing a message digest, or
  94.      encoding in printable ASCII. The <CR><LF> processing compensates
  95.      for differences in line delimiters in different operating
  96.      systems. RDEMO has a maximum file size of 1000 bytes.
  97.  
  98.   4. RDEMO defaults to the MD5 message-digest algorithm for all
  99.      signatures. If you want the MD2 message-digest algorithm, put
  100.      the string '-2' on the command line when you start RDEMO.
  101.  
  102.   5. If you want RDEMO not to display the main menu or any prompts,
  103.      put the string '-s' on the command line when you start RDEMO.
  104.      This is useful when RDEMO's input stream comes from a script
  105.      file.
  106.  
  107.   6. RDEMO seeds RSAREF's random number generator with a fixed value.
  108.      As a result, RDEMO sessions with the same commands and
  109.      parameters produce the same results. The use of a fixed seed
  110.      value is not recommended for non-demonstration applications.
  111.